home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / aio_suspend.z / aio_suspend
Encoding:
Text File  |  2002-10-03  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. AAAAIIIIOOOO____SSSSUUUUSSSSPPPPEEEENNNNDDDD((((3333))))                                                  AAAAIIIIOOOO____SSSSUUUUSSSSPPPPEEEENNNNDDDD((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aio_suspend, aio_suspend64 - wait for an asynchronous I/O request
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaaiiiioooo....hhhh>>>>
  13.  
  14.      iiiinnnntttt aaaaiiiioooo____ssssuuuussssppppeeeennnndddd((((ccccoooonnnnsssstttt aaaaiiiiooooccccbbbb____tttt **** ccccoooonnnnsssstttt aaaaiiiiooooccccbbbbpppp[[[[]]]],,,, iiiinnnntttt ccccnnnntttt,,,, ccccoooonnnnsssstttt ttttiiiimmmmeeeessssppppeeeecccc____tttt ****ttttiiiimmmmeeeeoooouuuutttt))));;;;
  15.  
  16.      iiiinnnntttt aaaaiiiioooo____ssssuuuussssppppeeeennnndddd66664444((((ccccoooonnnnsssstttt aaaaiiiiooooccccbbbb66664444____tttt **** ccccoooonnnnsssstttt aaaaiiiiooooccccbbbbpppp[[[[]]]],,,, iiiinnnntttt ccccnnnntttt,,,, ccccoooonnnnsssstttt ttttiiiimmmmeeeessssppppeeeecccc____tttt ****ttttiiiimmmmeeeeoooouuuutttt))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The _a_i_o__s_u_s_p_e_n_d() function shall suspend the calling thread until at
  20.      least one of the asynchronous I/O operations referenced by the _a_i_o_c_b_p
  21.      argument has completed, until a signal interrupts the function, or if
  22.      _t_i_m_e_o_u_t is not NULL, until the time interval specified by _t_i_m_e_o_u_t has
  23.      passed. If any of the _a_i_o_c_b structures in the list correspond to the
  24.      completed asynchronous I/O operations(i.e., the error status for the
  25.      operation is not equal to EINPROGRESS, at the time of the call), the
  26.      function shall return without suspending the calling thread. The _a_i_o_c_b_p
  27.      argument points to an array of pointers to asynchronous I/O control
  28.      blocks. The _c_n_t argument indicates the number of elements in the array.
  29.      Each _a_i_o_c_b structure pointed to shall have been used in initiating an
  30.      asynchronous I/O request via _a_i_o__r_e_a_d(), _a_i_o__w_r_i_t_e(), or _l_i_o__l_i_s_t_i_o().
  31.      This array may contain NULL pointers which shall be ignored. If this
  32.      array contains pointers that refer to _a_i_o_c_b structures which have not
  33.      been used in submitting asynchronous I/O, the effect is undefined.
  34.  
  35.      The _a_i_o__s_u_s_p_e_n_d_6_4() function is identical to _a_i_o__s_u_s_p_e_n_d() except that it
  36.      takes an  array of _a_i_o_c_b_6_4__t * (see <aaaaiiiioooo....hhhh>).  This structure allows for
  37.      the specification of a file offset greater than 2 Gigabytes.  The user
  38.      must define ____AAAABBBBIIII____SSSSOOOOUUUURRRRCCCCEEEE and include ----llllaaaabbbbiiii to access the _a_i_o_6_4 routines.
  39.  
  40.      If the time interval indicated in the _t_i_m_e_s_p_e_c structure pointed to by
  41.      _t_i_m_e_o_u_t passes before any of the I/O operations referenced by _a_i_o_c_b_p are
  42.      completed, then _a_i_o__s_u_s_p_e_n_d() shall return with an error.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      aio_read(3), aio_write(3), lio_listio(3), aio_sgi_init(3)
  46.  
  47. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  48.      If the _a_i_o__s_u_s_p_e_n_d() function returns after one or more asynchronous I/O
  49.      operations has completed, zero is returned.
  50.  
  51.      The application may determine which asynchronous I/O completed by
  52.      scanning the associated error and return status, using _a_i_o__e_r_r_o_r(_3) and
  53.      _a_i_o__r_e_t_u_r_n(_3), respectively.
  54.  
  55.      If any of the following conditions occur, the _a_i_o__s_u_s_p_e_n_d() function
  56.      shall return -1 and set _e_r_r_n_o to the corresponding value.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAAIIIIOOOO____SSSSUUUUSSSSPPPPEEEENNNNDDDD((((3333))))                                                  AAAAIIIIOOOO____SSSSUUUUSSSSPPPPEEEENNNNDDDD((((3333))))
  71.  
  72.  
  73.  
  74.      [EAGAIN]       No asynchronous I/O indicated in the list referenced by
  75.                     _a_i_o_c_b_p completed in the time interval indicated by
  76.                     _t_i_m_e_o_u_t.
  77.  
  78.      [EINTR]        A signal interrupted the _a_i_o__s_u_s_p_e_n_d() function. Note
  79.                     that, since each asynchronous I/O operation may possibly
  80.                     provoke a signal when it completes, this error return may
  81.                     be caused by the completion of one (or more) of the very
  82.                     I/O operation being awaited.
  83.  
  84.      [EAGAIN]       The system was short of resources and unable to wait for
  85.                     I/O.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.